Install the Agent on Linux

NOTE: Technical Preview Users: Uninstall any technical preview releases prior to installing the SysTrack 9.0 Agent. Follow the steps in section 2.1 to uninstall the endpoint system and remove it from the tree in SysTrack Deploy. After a successful uninstall, proceed with the following instructions.

This section provides comprehensive detailed instructions for setting up, downloading, and installing a Linux child agent. A bash shell script is required to install the Systems Management Agent on Linux. This script is an installation/removal script with a compressed tar file concatenated to the end of it that contains the actual agent files. This script is platform-specific.

SSL Preparation

The Linux child agent requires SSL (Secure Socket Layer) Certificate Verification in order to securely connect to the Master. This type of security protocol requires that a valid SSL certificate is installed on the Linux child system.

WARNING: Any additional root or intermediate certificates should be imported prior to proceeding to the next section.

Install

1. Download the SysTrack installation package on the client system and extract the contents.

   • For Cloud installations, click the Linux link under Agent Installers on the Configuration tab of the Cloud Tenant homepage to download ClientInstallLinux.zip.

   • For on-premises installations, download the installation package from the Lakeside Software release site using the following URL, where <version> is the version number of SysTrack you are installing. Contact Lakeside Support with questions.

     http://download.lakesidesoftware.com/SysTrack<version>_Install_Linux.zip

2. Navigate to the extracted location and change the rights of SystemsManagementAgentLinux.sh to all read, write, and executable.

   Example:

   sudo chmod ugo=wrx ./SystemsManagementAgentLinux.sh
   ls -lg
   will allow you to check the current rights for that file.

3. Install the Agent by running the SystemsManagementAgentLinux.sh script with the following parameters.

NOTE: This script must be run as root or through sudo.

Script Parameters	Description	Example
install	Required – Must be first parameter	N/A
-m <Master FQDN>	Required for Cloud deployments. No value required for On-Prem deployments. Pass this switch the on-prem SysTrack Master server Fully Qualified Domain Name.	master.lakesidesoftware.org
--config	Optional – Default SysTrack Configuration	SysTrack Test Config
--proxyconnectionhub	Optional – The name of their ProxyConnectionHub system (if applicable)	test.lakesidesoftware.org
--autodetectproxy	Optional – Preferred proxy setting: whether or not to use autodetect	N/A
--autoconfigscript	Optional – Preferred proxy setting: the address of a .pac file from which to get proxy information	http://test.lakesidesoftware.org/test.pac
--httpproxy	Optional – Preferred proxy setting: the address for the preferred HTTP proxy	127.0.0.1:80
--httpsproxy	Optional – Preferred proxy setting: the address for the preferred HTTPS proxy	127.0.0.1:443
--ftpproxy	Optional – Preferred proxy setting: the address for the preferred FTP proxy	127.0.0.1:21
--socketproxy	Optional – Preferred proxy setting: the address for the preferred Socket proxy	127.0.0.1:443
--context	Optional - Defines the system context value.	EMEA VIP

To install the Agent, use this:

On-Premises Installation Examples

Here is an installation example:

Here are some installation with proxy configuration examples:

Cloud Configuration Examples

Here are some cloud configuration examples:

Here are some cloud proxy configuration examples:

When Linux systems install, they install as a server by default, not as an endpoint.